為什麼要用 Echo？
還記得我們第一篇提到的，選擇 Go 語言的原因嗎？
高效率、併發性強，這些都是 Go 的優勢。
Echo 就像是為 Go 量身打造的「跑車」，它輕巧、快速，而且 API 設計得非常直覺易懂。
設想一下，你打算開設一家餐廳（這就是你的 Web 服務），需要一套點餐系統（對應路由），還有廚房（用來處理請求的函式，也就是 handler），當然也少不了負責收錢和送餐的人員（回應）。Echo 框架能協助你準備好所有這些流程，讓你專心開發「菜色」（也就是你的應用邏輯），不必把寶貴的時間浪費在煩惱「廚房怎麼蓋」、「菜單怎麼排」之類的問題。
Echo 的特色包括：
1.豐富的功能：路由、參數綁定、中介軟體 （Middleware）、模板渲染等，該有的都有。
2.簡潔的 API：語法清晰，學習曲線平緩。
3.高度可擴展性：你可以輕鬆加入自訂的功能。
準備好你的第一個 Echo 應用：Hello， World！
正所謂工欲善其事，必先利其器。我們在上一篇文章已經安裝好了 Go 環境，現在就來寫下你的第一個 Echo 應用吧！
首先，務必確認你的專案已經初始化了 Go modules。如果還沒做，回到你的專案目錄，執行：
go mod init your_module_name # 替換成你自己的 module name
接著，我們需要安裝 Echo 套件。執行：
go get github.com/labstack/echo/v4
現在，在你的 main.go 檔案裡，輸入以下程式碼：
package main
import (
"net/http"
"github.com/labstack/echo/v4"
)
func main() {
// 1) 開一間餐廳（建立 Echo）
e := echo.New()
// 2) 菜單：有人用 GET 訪問首頁 "/"，要回什麼
e.GET("/", func(c echo.Context) error {
// 3) 廚房出餐：回一段文字 + 成功狀態碼 200
return c.String(http.StatusOK, "Hello, Echo!")
})
// 4) 開門營業：在 8080 埠口等大家
e.Logger.Fatal(e.Start("0.0.0.0:8080"))
}
這段程式在做什麼
把程式想成餐廳：
優雅關閉 (Graceful Shutdown) 的重要性
在 Web 服務開發中，有一個非常重要的概念，那就是「優雅關閉」。想像一下，你正在享受美味的晚餐，餐廳突然停電了，所有人都被趕了出去，是不是很掃興？優雅關閉就像是餐廳在打烊前，先通知客人，讓他們有時間吃完飯，然後才慢慢關燈、打掃，確保每個人都能安心離開。
在軟體世界裡，優雅關閉指的是伺服器在收到關閉指令時，不是立刻停止服務，而是 先完成目前正在處理的請求，等到所有工作都告一段落後，再逐步關閉。這樣可以避免資料遺失、請求中斷等問題，提升使用者體驗。
在 Echo 中，實現優雅關閉其實並不難。我們只需要在 main 函式中稍微修改一下：
package main
import (
"net/http"
"os" // 引入 os 套件，用於接收系統訊號
"os/signal" // 引入 signal 套件，用於處理系統訊號
"time" // 引入 time 套件，用於設定等待時間
"github.com/labstack/echo/v4"
)
func main() {
e := echo.New()
e.GET("/", func(c echo.Context) error {
// 模擬一個比較耗時的請求
time.Sleep(5 * time.Second)
return c.String(http.StatusOK, "Hello, Echo!")
})
// 啟動伺服器
go func() {
if err := e.Start("0.0.0.0:8080"); err != nil && err != http.ErrServerClosed {
e.Logger.Fatalf("shutting down the server: %v", err)
}
}()
優雅關閉程式碼實作與測試
好的，現在讓我們來看看如何實際修改程式碼，為你的 Echo 應用程式加入「優雅關閉」的功能。這部分的程式碼稍微複雜一些，但別擔心，我會一步一步帶著你理解。
首先，讓我們來看看修改後的完整程式碼：
package main
import (
"context"
"net/http"
"os"
"os/signal"
"syscall"
"time"
"github.com/labstack/echo/v4"
"github.com/labstack/echo/v4/middleware"
)
func main() {
// Echo instance
e := echo.New()
// Middleware
e.Use(middleware.Logger())
e.Use(middleware.Recover())
// Route => handler
e.GET("/", func(c echo.Context) error {
time.Sleep(10 * time.Second) // 模擬耗時操作
return c.String(http.StatusOK, "Hello, Echo!")
})
// Start server in a goroutine
go func() {
if err := e.Start(":8080"); err != nil && err != http.ErrServerClosed {
e.Logger.Fatal("Shutting down the server")
}
}()
// 建立一個 channel，用於接收中斷訊號
quit := make(chan os.Signal, 1)
// 監聽 SIGINT (Ctrl+C) 和 SIGTERM (關閉指令)
signal.Notify(quit, os.Interrupt, syscall.SIGTERM) // 這裡需要引入 "syscall" 套件
// 阻塞，直到收到訊號
<-quit
e.Logger.Info("Shutting down server gracefully...")
// 建立一個帶有超時的 context，防止無限期等待
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) // 這裡需要引入 "context" 套件
defer cancel() // 確保 context 在函數結束時被取消
// 執行優雅關閉
if err := e.Shutdown(ctx); err != nil {
e.Logger.Fatal(err)
}
e.Logger.Info("Server shut down successfully")
}
程式碼詳解
現在，讓我們逐行拆解這些修改，瞭解它們的作用：
瞭解程式碼後，最重要的就是實際測試，確認優雅關閉是否真的有效！
如果看到這些訊息，恭喜你！ 你的 Echo 伺服器已經成功實現了 優雅關閉 功能！
通過這個簡單的範例，你現在應該對如何在 Echo 框架中實現優雅關閉有了更深入的瞭解。
iThome鐵人賽
看影片追技術